.. |kIRed_ic| image:: Img/qIRed.png
.. |kOtm_ic| image:: Img/qOtm.png
.. |kShrift_ic| image:: Img/qShrift.png
.. |kStr_ic| image:: Img/qStr.png
.. |kSpis_ic| image:: Img/qSpis.png
.. |kZit_ic| image:: Img/qZit.png
.. |kInte_ic| image:: Img/qInte.png
.. |kWik_ic| image:: Img/qWik.png
.. |kIso_ic| image:: Img/qIso.png
.. |kTab_ic| image:: Img/qTab.png
.. |kLin_ic| image:: Img/qLin.png
.. |kOchis_ic| image:: Img/qOchis.png
.. |kRasv_ic| image:: Img/kRasv.png
.. |kSv_ic| image:: Img/kSv.png
.. |kSvRasv_ic| image:: Img/kSvRasv.png
.. |kZOtch_ic| image:: Img/kZOtch.png
.. |kiKale_ic| image:: Img/kiKale.png
.. |kiChas_ic| image:: Img/kiChas.png
.. |kiOchis_ic| image:: Img/kiOchis.png
.. |kIKalegod_ic| image:: Img/kIKalegod.png
.. |kiTekVr_ic| image:: Img/kiTekVr.png
.. |usSpec_ic| image:: Img/usSpec.png
.. |usSled_ic| image:: Img/usSled.png
.. |usNaz_ic| image:: Img/usNaz.png
.. |usStre_ic| image:: Img/usStre.png
.. |usOSp_ic| image:: Img/usOSp.png
.. |form_use_markdown_icon_ic| image:: Img/form_use_markdown_icon_ic.png



###############################
Руководство по работе с формой.
###############################


**************************************
Работа с элементами управления формой.
**************************************

В Системе форма содержит следующие элементы управления:

* `Элемент управления Кнопка`_.
* `Элемент управления Флаг`_.
* `Элемент управления Переключатель`_.
* `Элемент управления Стрелка`_.
* `Значок очистки значения поля`_.

.. _Элемент управления Кнопка:

**Элемент управления «Кнопка».**

Элемент управления «Кнопка» (button) является очень важным элементом формы, поскольку именно с кнопками связаны различные действия, выполняемые пользователем в приложении (сохранение введенных данных, вызов другой формы, отмена действий и т. д.). Обычно кнопка выбирается, когда пользователь щелкает по ней мышью. Однако можно выбрать (нажать, т. к. визуально это именно так и выглядит) кнопку, используя только клавиатуру. Для этого нужно поместить на нее фокус, т. е. сделать активной, нажимая клавишу <Таb>, а затем нажать клавишу <Enter>. Для этой же цели можно назначить кнопке специальную комбинацию клавиш. Для назначения кнопке специальной комбинации клавиш необходимо обратиться к Администратору Системы.

В качестве примера можно привести форму *Вызов врача* в *Каталоге услуг* (:numref:`7Pic1d`).

.. _7Pic1d:          
.. figure:: Img/kKnop.png
       :scale: 80 %
       :align: center

       *Использование кнопок в форме*

Здесь кнопка *ОТПРАВИТЬ* позволяет провести отправку данных из заполненной формы, а кнопка *ОТМЕНИТЬ* - закрыть форму ввода данных без сохранения изменений.

.. _Элемент управления Флаг:

**Элемент управления «Флаг».**

Флаг, флаговая кнопка, чекбокс (от англ. check box), галочка — элемент графического пользовательского интерфейса, позволяющий пользователю управлять параметром с двумя состояниями — ☑ включено и ☐ отключено. Во включённом состоянии внутри чекбокса отображается отметка (галочка (✓), или реже крестик(×)). По традиции флажок имеет квадратную форму. Рядом с флажком отображается его обозначение, обычно — подпись, реже — значок. Для увеличения площади активного элемента обычно одинаково реагирует на нажатие мышью как на сам флажок, так и на подпись к нему.

В качестве примера можно привести форму *Редактор форм* (:numref:`7Pic2d`).

.. _7Pic2d:          
.. figure:: Img/kRedF.png
       :scale: 80 %
       :align: center

       *Выбор состояния записи в "Редакторе форм"*

Здесь включенным флагом ☑ определяются активные записи, с которыми возможно проводить действия. Записи с отключенным флагом останутся неактивными и действия с ними проводиться не будут.

.. _Элемент управления Переключатель:

**Элемент управления «Переключатель».**

Переключатель (toggle) - это элемент управления, который пользователь может включить или отключить. Элемент управления «Переключатель» работает так же, как «Флаг».

Так, при редактировании формы отключенный переключатель позволяет сделать невидимым вводимый компонент (:numref:`7Pic3d`). Как следствие, при использовании формы компонент не будет отображаться.

.. _7Pic3d:          
.. figure:: Img/kTVik.png
       :scale: 80 %
       :align: center

       *Состояние переключателя - "Выключено"*

Включенный переключатель позволяет отобразить компонент при использовании формы (:numref:`7Pic4d`).

.. _7Pic4d:          
.. figure:: Img/kTVkl.png
       :scale: 80 %
       :align: center

       *Состояние переключателя - "Включено"*

.. _Элемент управления Стрелка:

**Элемент управления «Стрелка».**

* Стрелки развертывания/свертывания формы.

Стрелки развертывания/свертывания формы используются для представления формы в развернутом |kRasv_ic| или свернутом |kSv_ic| виде.
Пример свернутой формы представлен на рисунке (:numref:`7Pic5d`)

.. _7Pic5d:          
.. figure:: Img/kSvForm.png
       :scale: 80 %
       :align: center

       *Свернутые формы*

Пример развернутой формы представлен на рисунке (:numref:`7Pic6d`)

.. _7Pic6d:          
.. figure:: Img/kRasvForm.png
       :scale: 80 %
       :align: center

       *Развернутые формы*

* Стрелка развертывания/свертывания списка.

Стрелка развертывания/свертывания списка |kSvRasv_ic| предназначена для развертывания/свертывания списка возможных значений поля. При нажатии стрелки |kSvRasv_ic| на свернутом списке (:numref:`7Pic7d`) происходит его раскрытие и с помощью левого клика мыши становится возможным выбор значения поля из списка значений по умолчанию (:numref:`7Pic8d`).

.. _7Pic7d:          
.. figure:: Img/kSvSpi.png
       :scale: 80 %
       :align: center

       *Свернутый список*

.. _7Pic8d:          
.. figure:: Img/kRasvSpi.png
       :scale: 80 %
       :align: center

       *Развернутый список*

.. _Значок очистки значения поля:

**Значок очистки значения поля.**

При левом клике мыши на значок очистки значения поля |kZOtch_ic| происходит удаление значение поля (:numref:`7Pic9d`) и (:numref:`7Pic10d`). 

.. _7Pic9d:          
.. figure:: Img/kOtch.png
       :scale: 80 %
       :align: center

       *Поле со значением*

.. _7Pic10d:          
.. figure:: Img/kOtchPo.png
       :scale: 80 %
       :align: center

       *Очищенное значение поля*

**********************
Работа с полями формы.
**********************

В Системе форма содержит следующие поля ввода данных:

* `Поле ввода Дата Время`_.
* `Текстовые поля`_.
* `Поле markdown`_.
* `Числовые поля`_.

.. _Поле ввода Дата Время:

================================================
**Поле ввода Дата/Время.**
================================================


Элемент интерфейса позволяет осуществлять ввод даты и времени, представленные в машиночитаемом формате. Он может быть полезен для создания расписаний, архивов или других функций, связанных со временем (:numref:`7Pic11dd`).

.. _7Pic11dd:          
.. figure:: Img/kDat.png
       :scale: 80 %
       :align: center

       *Поле ввода Дата/Время*

Поле ввода Дата/Время содержит следующие элементы управления: иконка ввода даты, иконка ввода времени, позволяющие выбрать дату и время, и поле, в котором отображаются выбранные дата и время.

При левом клике мыши по кнопке установки даты |kiKale_ic| происходит открытие календаря (:numref:`7Pic12dd`).

.. _7Pic12dd:          
.. figure:: Img/kDatKalen.png
       :scale: 80 %
       :align: center

       *Календарь*

Выбор даты осуществляется с помощью левого клика мыши. При нажатии на иконку |kIKalegod_ic| "Список годов" можно переключиться на форму списка выбора года (:numref:`7Pic13dd`).

.. _7Pic13dd:          
.. figure:: Img/kKalegod.png
       :scale: 80 %
       :align: center

       *Форма списка годов*

Возврат в форму календаря происходит при левом клике мыши по кнопке "Возврат в календарь" (:numref:`7Pic13dd`). 

После заполнения поля "Дата/Время" значением даты в поле появляются иконки очистки поля |kiOchis_ic| и ввода времени |kiChas_ic| (:numref:`7Pic13da`). 

.. _7Pic13da:          
.. figure:: Img/khis.png
       :scale: 80 %
       :align: center

       *Заполненное поле*

Левый клик мыши по иконке очистки поля |kiOchis_ic| позволяет удалить введенные данные и очистить поле.

Левый клик мыши по иконке ввода времени |kiChas_ic| открывает форму ввода времени.

.. _7Pic14dd:          
.. figure:: Img/kDatVrem.png
       :scale: 80 %
       :align: center

       *Форма ввода времени*

Часы и минуты устанавливаются с помощью перемещения бегунка в соответствующем поле нажатой и удерживаемой левой клавишей мыши. Нажатие кнопки "Установка текущего времени" |kiTekVr_ic| позволяет установить текущее системное время.

.. _Текстовые поля:

================================================
**Текстовые поля.**
================================================

Текстовые поля предназначены для ввода простого текста (:numref:`7Pic15dd`). 

.. _7Pic15dd:          
.. figure:: Img/kText.png
       :scale: 80 %
       :align: center

       *Текстовое поле*

После заполнения поля справа появляется значок |kZOtch_ic|, при нажатии на который левой кнопкой мыши происходит очистка значения поля (:numref:`7Pic16dd`).

.. _7Pic16dd:          
.. figure:: Img/kZText.png
       :scale: 80 %
       :align: center

       *Очистка текстового поля*

.. _Поле markdown:

================================================
**Поле markdown.**
================================================

Поле Markdown это поле типа rich-text. Rich-text поле используется в формах для обработки и хранения форматированного текста , например для описания запроса, в формате языка разметки Markdown. Markdown – облегченный язык разметки, созданный для написания, чтения, оформления веб-текстов.

Для создания описания в поле формы *Описание запроса* (:numref:`7Pic17d`) следует нажать на символ |kIRed_ic|, после чего откроется редактор Markdown (:numref:`7Pic18d`). 

.. _7Pic17d:          
.. figure:: Img/kZapr.png
       :scale: 80 %
       :align: center

       *Поле Описание запроса*

.. _7Pic18d:          
.. figure:: Img/kRedakt.png
       :scale: 80 %
       :align: center

       *Редактор Markdown*

Далее следует ввести в редакторе Markdown описание запроса в формате языка разметки Markdown.

В редакторе существует следующая система управления:

Кнопки |kOtm_ic| позволяют отменить последние действия.
Кнопка *Стиль заголовка* с всплывающим списком позволяет выбрать один из шести стилей заголовка (:numref:`7Pic19d`).

.. _7Pic19d:          
.. figure:: Img/kStil.png
       :scale: 80 %
       :align: center

       *Кнопка *Стиль заголовка**

Кнопки |kShrift_ic| позволяют выбрать стиль шрифта.

Кнопка |kStr_ic| позволяет вводить строчный код.

Кнопки |kSpis_ic| позволяю вводить ненумерованный и нумерованный список.

Кнопка |kZit_ic| позволяет выделить текст как цитату.

Кнопка |kInte_ic| позволяет вставлять ссылки на страницы в интернете.

Кнопка |kWik_ic| позволяет добавлять wiki-ссылки. Адрес ссылки вставляется автоматом и берется либо из параметров формы, либо из глобальных настроек.

Кнопка |usSpec_ic| позволяет вставить в текст спецсимвол. Спецсимволы – это набор последовательностей, которые заменяют запрещенные для ввода с клавиатуры символы.

При нажатии на кнопку |usSpec_ic| открывается форма ввода спецсимволов (:numref:`7Pic19ue`).

.. _7Pic19ue:          
.. figure:: Img/usTabsI.png
       :scale: 80 %
       :align: center

       *Форма выбора спецсимвола*

Выбор спецсимвола производится левым кликом мыши по иконке спецсимвола, после чего он отобразится в поле **Выбран символ**. Вставка спецсимвола в текст происходит при нажатии кнопки **ОК** в правом нижнем углу формы. При нажатии кнопки **ОТМЕНА** в правом нижнем углу формы происходит закрытие формы без вставки символа (:numref:`7Pic19ue`).

Навигация по листам с иконками спецсимволов производится с помощью кнопок |usSled_ic| и |usNaz_ic| (:numref:`7Pic19ue`).

После выбора спецсимвола в поле **Чарт символа** отображается имя блока кодировки. Блок кодировки так же возможно выбрать с помощью стрелки |usStre_ic| в правой части поля **Чарт символа**. Кнопка |usOSp_ic| позволяет перейти из блока кодировки Halfwidth and Fullwidth Forms в блок кодировки Specials (:numref:`7Pic19ue`).

Подробную информацию по спецсимволам можно получить по ссылке https://unicode-table.com/ru/.

Кнопка |kIso_ic| позволяет добавить файл рисунка.

Кнопка |kLin_ic| позволяет добавить горизонтальную линию.

Кнопка |kTab_ic| позволяет добавить таблицу.
Кнопка |form_use_markdown_icon_ic| позволяет добавить иконку из приложения в поле.

Кнопка |kOchis_ic| в правом верхнем углу редактора позволяет очистить поле редактирования.

Подробную информацию о языке разметки Markdown можно получить по ссылкам:

https://www.markdownguide.org/extended-syntax/

https://texterra.ru/blog/ischerpyvayushchaya-shpargalka-po-sintaksisu-razmetki-markdown-na-zametku-avtoram-veb-razrabotchikam.html

================================================
**Автозаполнение полей.**
================================================

Автозаполнение полей - при выборе одного параметра происходит автоматическое заполнение одного или нескольких полей (:numref:`7Pic20d`).

.. _7Pic20d:          
.. figure:: Img/kSZap.png
       :scale: 80 %
       :align: center

       *Выбор параметра при автозаполнении*

При выборе одного из флагов параметров заполнения (:numref:`7Pic20d`) (левый клик мыши) производится автоматическое заполнение полей в панели "Свернутые поля для заполнения" (:numref:`7Pic21d`).

.. _7Pic21d:          
.. figure:: Img/kSZapol.png
       :scale: 80 %
       :align: center

       *Автозаполненные поля*

.. _Числовые поля:

**Числовые поля.**

Числовые поля - это поля для ввода числовых значений. Поле позволяет ввести в форму целочисленные данные или данные с плавающей точкой (:numref:`7Pic22d`).

.. _7Pic22d:          
.. figure:: Img/kChis.png
       :scale: 80 %
       :align: center

       *Числовое поле*